home *** CD-ROM | disk | FTP | other *** search
/ LOGIC 2000 February / LogicCd--feb.2000-mac-cdr.iso / Apple II / Utilities / Disk2File30 / DOCS.80 < prev    next >
Encoding:
Text File  |  1995-10-29  |  5.6 KB  |  157 lines  |  [TEXT/pdos]
  1.  
  2. DSK2FILE, version 3.0
  3.  
  4. Ronald T. Kneusel, October 1995. FREEWARE
  5. (rkneusel@post.its.mcw.edu)
  6.  
  7.  
  8. What is it?
  9. -----------
  10. DSK2FILE creates disk images of 5.25" disks (DOS 3.3 or ProDOS) for use with
  11. Apple ][ emulator programs.
  12.  
  13. DSK2FILE will create images in DOS 3.3 order (.DSK) or in ProDOS order (.PO)
  14. It does not matter what format the disk really is, you can use either order.
  15. Most emulators will handle DOS 3.3 order, some will also handle ProDOS order.
  16.  
  17.  
  18. What do I need to run it?
  19. -------------------------
  20.  
  21. You need a 5.25" drive and one of the following:
  22.  
  23. (0) another 5.25" drive
  24. (1) a 3.5" drive
  25. (2) a hard drive
  26. (3) a RAM card with 150K or more
  27.  
  28. DSK2FILE will create the file, it is up to you to get the file to the PC or
  29. Mac.  See below for suggestions on how to do this.
  30.  
  31.  
  32. Running DSK2FILE
  33. ----------------
  34.  
  35. DSK2FILE's menu has two choices:
  36.  
  37. (1) 140K DISK -> IMAGE FILE
  38. (2) IMAGE FILE -> 140K DISK
  39.  
  40. and some options,
  41.  
  42. (3) SEGMENTED R/W
  43. (4) IMAGE FILE ORDER
  44.  
  45. You will likely use (1) the most often.  The second option is for those who
  46. might come across an image file and want to put that file back onto a disk
  47. and run it on a real Apple ][.
  48.  
  49. Use segmented read/write when you have only two 5.25" drives.  This will
  50. output the image into two 70k file which will fit on two 5.25" floppies.
  51. Use the proper split/merge program for the computer on which you will use
  52. the image to piece it together again.  The program should be available from
  53. the same place you got this program.
  54.  
  55. Select an image option, either DOS 3.3 or ProDOS, for the image to create
  56. or for the image being written to an actual disk.
  57.  
  58.  
  59. (1) 140K -> IMAGE FILE
  60.  
  61. DSK2FILE reads only 5.25" disks from slot 6, drive 1.  Enter the complete
  62. pathname for the output file.  The image order and segmenting were selected
  63. via the options on the main menu.
  64.  
  65. Insert the disk when asked and press return.  The image file will be created.
  66.  
  67.  
  68. (2) IMAGE FILE -> 140K DISK
  69.  
  70. Insert a *formatted* 5.25" disk in slot 6, drive 1 and specify the *complete*
  71. pathname of the image file as above.  Use the options to select the right
  72. image order.  Use ProDOS order for .PO images and use DOS order for .DSK
  73. and .DO image files.
  74.  
  75.  
  76. What's with the DOS and ProDOS orders?
  77. --------------------------------------
  78.  
  79. The Apple ][ has two different disk operating systems: DOS 3.3 and ProDOS.
  80. (Yes, there are several others, I'm simplifying a bit, I know :)
  81.  
  82. DOS 3.3 is the older and slower of the two and deals in 256 byte sectors with
  83. 16 sectors per track and 35 tracks per 5.25" disk.  ProDOS is faster and deals
  84. with 512 byte blocks, 280 per 5.25" disk.  Therefore, each ProDOS block
  85. corresponds to two sectors.  However, these are not necessarily contiguous
  86. sectors.  ProDOS uses a different physical spacing of what DOS 3.3 would call
  87. sectors so that reading all the blocks from 0 to 279 in order writes the data
  88. on the disk to the file in one order while using track 0 to 34 and sector 0
  89. to 15 for each track will write the data in a different order.  Either way,
  90. all the data will be written, 143360 bytes total.
  91.  
  92.  
  93. How does it work?
  94. -----------------
  95.  
  96. Glad you asked! :)
  97.  
  98. DSK2FILE must run under ProDOS because it uses ProDOS MLI commands to handle
  99. the disk files.  This relieves the user from caring about the file type of
  100. the image file.  It also makes it much easier than using old DOS 3.3 RWTS
  101. calls.
  102.  
  103. The disk is read, block by block, and written to the output file in 512 byte
  104. sections.  If the output is to be in DOS 3.3 order a map is applied to the
  105. block number to translate it into a track and sector with the appropriate
  106. 256 byte section of the block being written.  This is the easy part.
  107.  
  108. Writing an image to a disk is just as easy if the image is in ProDOS order.
  109. Read 512 bytes from the file and write it to block 0 and so on.  If it is a
  110. DOS 3.3 order image file life gets a bit tricky since we can only read and
  111. write 512 byte blocks but we are working with half a block at a time.  The
  112. solution is to read the existing block, then read the 256 bytes from the image
  113. file and put it in the right half of the block buffer.  Then write the entire
  114. block back to disk.  This is why going from a DOS 3.3 image file to a disk
  115. takes longer.
  116.  
  117.  
  118. What do I do with the image file?
  119. ---------------------------------
  120.  
  121. The end goal, of course, is to get the file to a PC or Macintosh (or Unix box)
  122.  
  123. I use a terminal program to upload the image file (written to my RAM card) to
  124. a Unix box and then download it to the Mac or PC. (Really, I FTP it since I
  125. have Internet access)  Another option is to use a null modem cable and go
  126. directly to a PC or Mac with the image file.  Lastly, you could write the file
  127. to a 3.5" ProDOS disk and use a Mac to read the file with Apple File Exchange.
  128. Then you could write the file to a PC disk if need be.
  129.  
  130. If the image file is in two pieces use the Split/Merge program for your
  131. computer (PC, Mac, or Unix).  This will merge a split image file or
  132. create a split image for use with an Apple that has only 5.25" drives.
  133.  
  134.  
  135. It doesn't work, now what?
  136. --------------------------
  137.  
  138. Contact me at the email address above.  If you start seeing two digit hex
  139. numbers please write them down to help me in the debuging.  These are ProDOS
  140. MLI error codes.  DSK2FILE will not read copy protected disks.  Disks with
  141. bad blocks or sectors will still be written to an image file with nonsense
  142. in the bad block or sector. (Actually, it will be the data that was in the last
  143. block or sector successfully read)
  144.  
  145.  
  146. I'm in the dark ages and don't have email, how to I contact you?
  147. ------------------------------------------------------------ ----
  148.  
  149. If you feel a compelling need you can try snail mail:
  150.  
  151. Ron Kneusel
  152. 8725 W Burdick Ave
  153. Milwaukee, WI 53227 USA
  154.  
  155. AMDG
  156.  
  157.